Boost.Test

C++ 11 Added in Boost 1.29.0

Categories: Correctness

Support for simple program testing, full unit testing, and for program execution monitoring.

Documentation www.boost.io/doc/libs/release/libs/test/index.html

GitHub Issues github.com/boostorg/test/issues

Source Code github.com/boostorg/test/tree/boost-1.86.0

This Release

Gennadiy Rozental

Maintainer

Raffi Enficiaud

Maintainer

Matt Borland

Maintainer

Keerthi Timmaraju

Contributor - New

Rene Rivera

Contributor

What is Boost.Test?

Boost.Test is a C++11/14/17 unit testing library, available on a wide range of platforms and compilers.

The library is part of Boost. The latest release of the library is available from the boost web site.

Full instructions for use of this library can be accessed from http://www.boost.org/doc/libs/release/libs/test/

Key features

Easy to get started with:

download and deflate the latest boost archive

create a test module with this (header version):

#define BOOST_TEST_MODULE your_test_module
#include <boost/test/included/unit_test.hpp>

Write your first test case:

BOOST_AUTO_TEST_CASE( your_test_case ) {
    std::vector<int> a{1, 2};
    std::vector<int> b{1, 2};
    BOOST_TEST( a == b );
}

build and run
done

powerful and unique test assertion macro BOOST_TEST, that understands floating points, collections, strings... and uses appropriate comparison paradigm
self-registering test cases, organize cases in test suites, apply fixtures on test cases, suites or globally
provide assertion context for advanced diagnostic on failure
powerful and extensible dataset tests
add decoration to test cases and suites for advanced description, group/label, and dependencies
powerful command line options and test case filters
extensible logging, XML and JUNIT outputs for third-party tools (eg. cont. integration)
various usage (shared/static library/header only) for faster integration and/or compilation/build cycles, smaller binaries

Copyright and license

Distributed under the Boost Software License, Version 1.0.
(Get a copy at www.boost.org/LICENSE_1_0.txt)

Contribute

Please read this document to get started.

Build Status

Boost.Test uses mostly the facility provided by our wonderful Boost testers (column Tests below).

Branch	Deps	Docs	Tests	Github Actions
`master`
`develop`

All Time

Raffi Enficiaud

Contributor

Raffi Enficiaud

Contributor

Raffi Enficiaud

Contributor

Andrzej Krzemieński

Contributor

Raffi Enficiaud

Contributor

Beman Dawes

Contributor

Steven Watanabe

Contributor

John Maddock

Contributor

Jürgen Hunold

Contributor

Vladimir Prus

Contributor

Douglas Gregor

Contributor

nobody

Contributor

jamie

Contributor

Marshall Clow

Contributor

Peter Dimov

Contributor

Adam Wulkiewicz

Contributor

Andrey Semashev

Contributor

K. Noel Belcourt

Contributor

Dave Abrahams

Contributor

Antony Polukhin

Contributor

Troy D. Straszheim

Contributor

Markus Schöpflin

Contributor

David Deakins

Contributor

Roland Schwarz

Contributor

Victor A. Wagner Jr.

Contributor

Daniel James

Contributor

Bryce Adelstein-Lelbach

Contributor

James E. King III

Contributor

akumta

Contributor

Eric Niebler

Contributor

Marcel Raad

Contributor

Jens Maurer

Contributor

Jeremiah Willcock

Contributor

Paul A. Bristow

Contributor

Vicente J. Botet Escriba

Contributor

Edward Diener

Contributor

Marek Kurdej

Contributor

Aleksey Gurtovoy

Contributor

Jonathan Turkanis

Contributor

Joaquín M. López Muñoz

Contributor

Ed Catmur

Contributor

Ed Catmur

Contributor

Boris Gubenko

Contributor

Toon Knapen

Contributor

Mateusz Łoskot

Contributor

Norbert Wenzel

Contributor

Gennaro Prota

Contributor

Jonathan Wakely

Contributor

Benjamin Roland Buch

Contributor

Edward Diener

Contributor

Stephen Kelly

Contributor

BenWiederhake

Contributor

Noel Belcourt

Contributor

Romain Geissler

Contributor

Aaron Gorenstein

Contributor

Gabriel Hege

Contributor

zerotypos-found

Contributor

Tim Blechmann

Contributor

Brian Kuhl

Contributor

Marek Kurdej

Contributor

Bevan Collins

Contributor

Ben Wiederhake

Contributor

George Koehler

Contributor

Mikhail Strelnikov

Contributor

Jan Bouwer

Contributor

equal-l2

Contributor

Tom Hughes

Contributor

Reimar Döffinger

Contributor

Laurent Stacul

Contributor

Peter Klotz

Contributor

Daniela Engert

Contributor

Michael A. Jackson

Contributor

ja11sop

Contributor

Daniel Laügt

Contributor

Jörg Böhme

Contributor

wwinder

Contributor

Jörg Krause

Contributor

André Draszik

Contributor

Adam Majer

Contributor

Jonnahtan Saltarin

Contributor

Namezero

Contributor

Nathan Toone

Contributor

Juan Alday

Contributor

Rainer Deyke

Contributor

Tien Do

Contributor

Peter Jansson

Contributor

Luke Peterson

Contributor

Kedar R. Bhat

Contributor

Mikhail Pilin

Contributor

Alexander Grund

Contributor

mmitti

Contributor

Hartmut Kaiser

Contributor

Partha P. Mukherjee

Contributor

Andrey Semashev

Contributor

Jurko Gospodnetić

Contributor

Peter Dimov

Contributor

Eugene Zelenko

Contributor

Vladimir Prus

Contributor

Pino Toscano

Contributor

Jessica Hamilton

Contributor

Jere Pehkonen

Contributor

Giovanni Mascellani

Contributor

Ralf W. Grosse-Kunstleve

Contributor